4D Doc Center : CT Chart arrays

4D Chart v13

CT Chart arrays


CT Chart arrays ( area ; type ; size ; categoryArray ; seriesArray ; valuesArray ) -> 戻り値

引数	型	説明
area	倍長整数	4D Chart エリア
type	整数	グラフのタイプ (以下のコードを参照)
size	整数	グラフの初期サイズオプション 1 = 可変 2 = ウインドウと連動 (自動-変数) 3 = グラフと連動 (自動-ドキュメント)
categoryArray	配列	項目配列
seriesArray	配列	系列配列
valuesArray	配列	数値配列
戻り値	倍長整数	オブジェクトID番号

説明

CT Chart arrays 関数は、指定された配列に基づいてグラフを作成し、そのグラフのオブジェクトIDを返します。このコマンドは2次元グラフまたは3次元グラフのどちらを作成するときにも使用できます。

以下の表は、引数 type のコードを示しています。

コード	チャートタイプ
1	面
2	棒
3	ピクチャ
4	線
5	散布図
6	円
7	ポーラー
8	2D XY
100	3D 棒
101	3D 線
102	3D 面
103	3D 等高線
104	3D 三角形
105	3D ピン

引数 size は、グラフが生成されたときにそのグラフがどの程度のスペースを取るのか、ウインドウのサイズ変更をしたときにグラフのサイズはどのように変更するのかを決定します。

1を渡した場合 (サイズの変数) 、グラフは4D Chart エリアかまたはウインドウいっぱいになります。ハンドルを使って修正するまでこのサイズは保たれます。
2を渡した場合 (ウインドウと連動したサイズ) 、グラフは4D Chart エリアかまたはプラグインウインドウいっぱいになります。ウインドウサイズを変更した後は、グラフは自動的に変えられます。しかしながら、一度ハンドルを使ってグラフサイズを変更すると、この変更はそれ以上実行されません。
3を渡した場合 (文章と連動したサイズ) 、グラフはページセットアップダイアログボックスで選択したページの次元に合わせて変えられます。ハンドルを使ってグラフサイズを修正するまでこのサイズは保たれます。

categoryArray には、X軸項目があります。

seriesArray には、系列が含まれます。2次元グラフでは、系列は項目軸上に表示されます。3次元グラフでは、系列は数値軸上に表示されます。

valuesArray は、数値軸上でグラフ化されるすべての値を含む1次元の配列です。categoryArray と seriesArray の各要素の値が存在するように valuesArray には値が入っている必要があります。つまり、n 項目と m 系列がある場合には、valuesArray には n*m 個の要素があることになります。

以下の図は、valuesArray に入れられるものの順序を示しています。n は項目の合計数を表します。m は系列の合計数を表します。

例えば、以下のデータと数値配列の結果を参照してください。

学校名 (項目)	年度 (系列)	生徒数(数値)	aValues
Sunnyoaks	1990	1000	aValues{1}:=1000
Sunnyoaks	1992	1250	aValues{2}:=600
Sunnyoaks	1994	800	aValues{3}:=1250
Valley	1990	600	aValues{4}:=975
Valley	1992	975	aValues{5}:=800
Valley	1994	1100	aValues{6}:=1100